**************************************************************************
(C) COPYRIGHT International Business Machines Corp. 1998,1999
    All Rights Reserved. Licensed Materials - Property of IBM.
**************************************************************************
FILE: README
 
IBM MultiProtocol Switched Services  Configuration
Program MSS Client V1 R2.2 is a replacement for 
IBM MultiProtocol Switched Services  Configuration
Program MSS Client V1 R2.1.
 
 The Nways Multiprotocol Access, Routing, and Switched Services 
 Configuration Program User's Guide is available separately (GC30-3830).
  
 Contents:
 
        1. Readme and informational files
        2. Installation
             Hardware and Software Requirements
             Obtaining the Configuration Program Electronically
             Procedure for Installing the Configuration Program
        3. Starting the Configuration Program
        4. Basic Guidelines for Using the Configuration Program
        5. Sending/Retrieving the Configuration File
        6. Problem Determination

 1. Readme and informational files
 
    Readme.txt - this file
    
    Release.txt - list of new functions in this release
                - restrictions for the release 
                - any migration considerations from earlier releases
                
    Content.txt - one for every PTF in a given release, cumulative
                - a summary of whether the PTF introduces new function
                  or is required to match a certain operational code PTF
                - for the GA level, the content document would refer to 
                  the release notes and state what Config Program PTF(s)
                  in prior releases this covers
                - for every PTF, add at the top of the file the APARs that
                  were added in this PTF   
 
 2. INSTALLATION

 Hardware and Software Requirements

  AIX
 
  a. RS/6000 Model 250/410 or better with minimum 80Mhz CPU
  b. 64 MB RAM (minimum)
  c. CD-ROM
  d. 54 MB free disk space. Additionally, you will need 1 to 3 MB for
      each configuration file.
  e. Graphics (1024 x 768 x 256 colors) display.
  f. 3-button mouse
  g. AIX for RS/6000 Version 4.1.5 or higher,
     AIXWindows, and Environment/6000.

  The Migration Tool, Conversion Program on AIX has special font requirements.
  You need to have /usr/lib/X11/fonts/75dpi/ in the list of directories.
 
  If you do not have this directory in your Xstation Font Path, then from
  your Xstation type:

   xset fp+ /usr/lib/X11/fonts/75dpi/
 
  This will add the Conversion Program font directory to your Xstation
  Font Path.  You may place the above line in your .profile for future use.

 OS/2
 
 a. IBM PC-compatible with Intel Pentium ** 166 MHz or higher processor (See Note 1)
 b. 48 MB RAM (minimum)
 c. CD-ROM
 d. 37 MB free disk space. Additionally, you will need 1 to 3 MB for
     each configuration file.
 e. 10 MB for Swapper space
 f. SVGA (1024x768x256 colors) display.
 g. OS/2 3.0 or higher, IBM TCP/IP 1.2.1 for OS/2 or higher

Microsoft Windows 95/98 or Windows NT

 a. IBM PC-compatible with Intel Pentium ** 166 MHz or higher processor (See Note 1)
 b. 48 MB RAM (minimum)
 c. CD-ROM
 d. 54 MB free disk space. Additionally, you will need 1 to 3 MB for
     each configuration file.
 e. SVGA (1024x768x256 colors) display.
 f. Microsoft Windows 95 or Windows NT.

Notes:
1. More memory and better processors will improve the program's performance.
2. You must make sure that TCP/IP is installed and running before using the
   "Single Send or Retrieve" or "Multiple Send or Retrieve" functions.


Obtaining the Configuration Program Electronically

  You can obtain the Configuration Program electronically, from
   http://www.networking.ibm.com/support/code.nsf/8270code
   
 Steps to obtain the Configuration Program electronically:
   
     1. From the URL above, select Config Program MSS Client Version 2.2
     2. Select from Files in the Package at the bottom of the screen to download 
        the files.  
         
  AIX 
  
     1. Download the mssc22ac file (27Meg) to a temporary directory.
     2. To install the Configuration Program, change to the directory where
     the mssc1r22 file(INSTALLP file) exists. Proceed from step 5 in the Install
     on AIX section below.
             
  OS/2
     1. Download the os2inst.cmd file (10Meg) to a temporary directory.
     2. To install the Configuration Program, 
        Enter os2inst.cmd on an OS/2 Command Window,
        follow the prompts that appear on the screen to complete the installation.
        
  Windows
     1. Download the MSSCV1R22.exe (11.5Meg) to a temporary directory.
     2. To install the Configuration Program, execute the self extracting 
        file MSSCV1R22.exe. Follow the prompts that appear on the screen 
	to complete the installation.


Procedure for Installing the Configuration Program

  Install on AIX

  1. Log on as the "root" user
  2. Insert the CD into your CD-ROM drive
  3. Mount the CD-ROM.
       a.  create directory /cdrom if one does not exist
       b.  mount -v cdrfs -r  /dev/cd0  /cdrom
  4. Cd to the directory where the INSTALLP file is located. On the CD it will 
     be in the /cdrom/config/aix/  directory.
  5. Run SMIT and do the following:
     
    Note: The following steps are based on AIX 4.1.5. 
          The steps are slightly different if you are using AIX 4.2 and later.
    
     a. Select "Software Installation and Maintenance."
     b. Select "Install and Update Software"
     c. Select "Install/Update Selectable Software (Custom Install)"
     d. Select "Install Software Products at Latest Level."
     e. Select "Install New Software Products at Latest Level."
     f. Enter the fully qualified filename of the INSTALLP file from the CD or the web.
        (Note that if you are in that directory already this becomes './mssc22ac'.
     g. Press PF4 to list the software and select the installation program.
     h. Select OK.
     j. Select OK.
     k. Select Done
     l. Select Cancel.
  6. Unmount the CD-ROM
          unmount /cdrom
  7. Exit root user.
  
  The Configuration Program was installed in the /usr/lpp/mssc22ac directory.

 Install on OS/2

  1. Insert the CD into your CD-ROM drive and change to the CD-ROM drive and the
     /config directory.
  2. From an OS/2 Command Window, enter os2inst
     Follow the prompts that appear on the screen to complete the installation.

 Install on Windows
  1. Insert the CD into your CD-ROM drive.
     If autoread is on, the installation program starts and presents 
     an installation dialog. Otherwise, run setup from the /config/win directory
     on the CD-ROM.  Follow the prompts that appear on the screen to
     complete the installation.
  

3. Starting the Configuration Program
 
   AIX
 
   1. X-Windows must be running on the workstation.
      Enter xinit to start X-Windows, if not already started.
   2. Change to the directory /usr/lpp/mssc22ac which will contain the 
      Configuration Program.
   3. Type config and press ENTER.

  * For AIX users, if you experience panel distortion problems, please 
    read the problem determination section for resolution.

   OS/2
 
   1. Locate and open the Configuration Program folder.
   2. Double-click on the Configuration Program icon to start the program.

  Windows
   1. Select the Configuration Program under Windows, select
       Start->Programs->folder->MSSCV1R2.2
     
   * For Windows users who launch multiple versions of the Configuration Program,
    your help system might not function correctly unless your HELP path is set 
    to include the current directory. 
    
       Windows NT users:  
         (1) Select Start->Settings->Control Panel
         (2) Select and double click the System Icon
         (3) Select the Environment Tab
         (4) Select HELP from the System Variable list
         (5) Add " .; " to the Value entry field in addition to what is already listed 
             (Do not enter the quotation marks)
         (6) Click the Set Button
         
       Windows 95 users:
         (1) Add the following statement to either the Config.sys or Autoexec.bat
             files which exist on your system:
             SET HELP=.;%HELP%
         (2) Shutdown and Reboot your system for this change to take effect.
  
    
  * For Windows users, if you experience panel distortion problems, please 
    read the problem determination section for resolution.
  
  From the Navigation Window, under the Help pulldown, there is a
 Tutorial available to help a new user get familiar with using the
 Configuration Program. 

4. Basic Guidelines for Using the Configuration Program
 
   This section is not a complete user's manual, but is intended to provide some common 
   guidance in using the configuration program.
 
   After you start the configuration program and clear the copyright notice, you
   will see two windows: the left-hand window is the Navigation window and the
   right-hand window is the Configuration window. The Configuration Program is
   designed as a point-and-click interfaces. You select items from the 
   Navigation Window and then fill in information on the Configuration Window.


   Guided Configuration 
     
     This option opens a help window when the tool opens and changes to 
     the appropriate help window as you change between selections on the 
     navigation view.  If you would rather not see this help you can turn it
     off by going to the Options->Guided Configuration Menu option
     from the main Menu bar.  When you exit the tool this option
     will be saved in the cfg.ini file to be used the next time
     the tool is invoked.
 

   Using the Mouse
 
   The mouse is the main tool you use to move through the various lists and
   panels in the Configuration Program.

   Examples:
   . Left - to select an item in a panel
   . Right - 
      On the Navigation Window
       - Display a pop-up menu for a selected item
       - You may select the 'Validate' option to display validation message(s) for 
         an item with '?' next to it.
      On Notebook pages
       - You may select the 'Validate' option to display validation message(s) for
         all the notebook pages.
     
  
   F1 (Help) - to request help
   
   To obtain help on a panel:
   1. Select an item in the Navigation Window.
   2. Press F1.

   To obtain help on a parameter, a button, or a drop-down list:
   1. Select the parameter field or button by tabbing to the field, button, or list.
   2. Press F1.


  Extended Selection to delete multiple entries

  1. Hold Left mouse button and Ctrl key simultaneously to select multiple 
     entries on a list
  2. Click on the Delete button on the panel

 
  Configuring Device Interfaces
 
  1. From the Navigation Window, click on the '+' next to Devices or double clicking
     the left mouse button to expand the folder;  then select Interfaces.
  2. From the Device Interfaces panel, select an interface
  3. To change Data link,  select click on the Data link column of the selected 
      interface,  click on the pull-down menu to select the desired data link. To
      refresh the panel for the new data link, click the  empty column next to
      the Data link.

  Configuring Interfaces Panels that have more than one columns

  1. From one of the Interfaces panel, select the desired interface
  2. Click on the column header of the feature you want to configure.

 
  

5. Sending/Retrieving the Configuration file
 
    Note: It helps to step through the Configuration Program as you read
          this.
 
    You MUST make sure that TCP/IP is installed and RUNNING before using
    the "Communications Single" and/or "Communications Multiple" functions.
 
    The Communications function will communicate with the router using
    the SNMP protocol.  The router must be set up with an IP Address and
    have a SNMP community with access defined as WRITE_READ_TRAP for send and
    restart. For retrieve and query, the community access can be READ_TRAP or
    WRITE_READ_TRAP.
 
    The single send will send the configuration that is currently open.  The
    IP destination and community fields will default to what is defined in
    the configuration.  The timeout value is the maximum number of seconds
    the send function will wait for a response.  Select the appropriate
    action(s):
      1.  Send the configuration to the router
      2.  Restart the router immediately or later
      3.  Send the configuration and then restart the router
      4.  Query the router for the System Description.
      5.  Retrieve the configuration from the router.
  
    For single router restart, the time initializes to the current time
    so the router will restart immediately.  However the 'Date' and 'Time'
    fields can be changed to any date and time.  For multiple router
    restart, the dates and times initialize to the last entered dates
    and times for each row in the selected send list.
 
    The 'All' button will apply the date and time specified in the
    'Restart at' area to each row in the list.  The 'Selected' button
    will only apply the date and time specified in the 'Restart at'
    area to the row selected.  The date and time fields in the table may
    also be directly edited.  If the Restart box is selected for a row
    and the date and time field are empty, the date and time will
    default to the date and time in the 'Restart at' area.
 
    Note:  If the restart is sent to the router with a date and time
    earlier than the current date and time on the workstation (for
    example yesterday's date), the router will be restarted immediately.
 
    The delayed restart time is sent to the router in the form of seconds
    (xx).  The router will restart at xx seconds from when he receives
    the packet (within a two minute window).  Therefore if there are many
    hops to the destination or the network traffic is heavy, the router
    may restart later than expected.
 
    If a timeout error occurs, check that:
      1. the IP Destination address is correct
      2. there is a route to the IP address
      3. the community exists
      4. the timeout value is large enough
      5. might be busy processing previous request
      
    NOTE:  
    	  When a configuration is sent to the MSS Family Client switch,
          it needs approximately 40 seconds to load the configuration 
          to the flash. During this time, the MSS Client Switch is not
          responding to the incoming SNMP request. If you requested
          both the send configuration and the restart router requests, 
          the suggested timeout is minimum of 45 seconds. This timeout
          is necessary for the device to finish processing the send
          configuration request before responding to the restart device 
          request.
             
 
    If an error with the SNMP packet occurs, check that:
      1. the community has WRITE_READ_TRAP access
      2. for multiple send, the configuration exists in the database
 
  Router configuration format(.cfg file readable by 8270)
 
  If you did not save ".csf" files using the previous versions of the
  Configuration Programs, you should find a copy of the Configuration
  Program which matches your router software to create ".csf" files.
  The Configuration Program  checks the level of the configuration at 
  the beginning of a READ ROUTER CONFIGURATION, and will terminate the 
  read if the level of the configuration does not match the level of the 
  Configuration Program.
 
   
6. Problem Determination
 
 The file, walkback.log is created when an internal execution error occurs 
 in the program. The contents of this file should be given to IBM support
 when a problem with the Configuration program is reported. The
 configuration files in all formats available should also be given to
 IBM support to assist with problem determination.
 
 NOTE:  The above mentioned file is written to the directory from which
 the Configuration Program was started.
 

Panel Display Problems on AIX

 On AIX, there is a known panel distortion problem on lower resolution monitors.
 If panels look distorted,  buttons (add, change, delete buttons) or fields appear
 missing,  please reduce the font size set on your AIX system.

  How to change fonts on your AIX system
 
   From your AIX 'Common Desktop Environment', click the 'Style Manager' icon on 
   your Front Panel. Click on 'Font', you will see a list of Relative font sizes 
   available on your system.  Change the font size to a smaller one, then restart 
   the Configuration Program.
  
Panel Display Problems on Windows

  On Windows, there is known panel distortion problem which might occur.
  If panels look distorted, fields, notebooks, and buttons appear missing,
  maximize that window, and then restore the window to its original size in
  order to correct the panel distortion.
    

8. Restrictions.
 
 This section discusses some KEY considerations that users must be
 aware of when creating valid configurations.
 
 -You MUST make sure that TCP/IP is installed and RUNNING before using
 the "Communications Single" and/or "Communications Multiple" functions.
 On some platforms, the Configuration Program will hang if TCP/IP is
 not installed and running.
 
 -ELS (Event Logging System) data
 The Configuration Program does not support ELS configurations.  Thus,
 if you want to configure ELS you must use the online configuration
 program on the router. When reading configurations from the router,
 the Configuration Program will preserve any ELS configuration done
 in the online configuration on the router and send it back on a
 subsequent send.
 


Trademarks
  The following items are trademarks of the IBM Corporation in the United States or
  other countries of both:

  AIX      RS/6000      Operating System/2      OS/2    Nways

  Microsoft, Windows, Windows NT, and the Windows 95 logo are trademarks
  or registered trademarks of Microsoft Corporation.

 Other company, product, and services names may be trademarks or service
 marks of others.
 
THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF
  ANY KIND.  IBM DISCLAIMS ALL WARRANTIES, WHETHER
  EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION,
  THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR
  PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE
  INFORMATION IN THIS DOCUMENT.  BY FURNISHING THIS
  DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR
  COPYRIGHTS.

  (C) Copyright IBM Corporation 1994,1999.  All rights
  reserved.



